// 版权所有2012 Go作者。版权所有。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// Package quotedprintable实现了
// RFC 2045指定的带引号的可打印编码。
package quotedprintable

import (
	"bufio"
	"bytes"
	"fmt"
	"io"
)

// 阅读器是一个引用的可打印解码器。
type Reader struct {
	br   *bufio.Reader
	rerr error  // 上次读取错误
	line []byte // 在多个br 
}

// NewReader返回一个引用的可打印读取器，从r解码。
func NewReader(r io.Reader) *Reader {
	return &Reader{
		br: bufio.NewReader(r),
	}
}

func fromHex(b byte) (byte, error) {
	switch {
	case b >= '0' && b <= '9':
		return b - '0', nil
	case b >= 'A' && b <= 'F':
		return b - 'A' + 10, nil
	// 接受编码错误的字节。
	case b >= 'a' && b <= 'f':
		return b - 'a' + 10, nil
	}
	return 0, fmt.Errorf("quotedprintable: invalid hex byte 0x%02x", b)
}

func readHexByte(v []byte) (b byte, err error) {
	if len(v) < 2 {
		return 0, io.ErrUnexpectedEOF
	}
	var hb, lb byte
	if hb, err = fromHex(v[0]); err != nil {
		return 0, err
	}
	if lb, err = fromHex(v[1]); err != nil {
		return 0, err
	}
	return hb<<4 | lb, nil
}

func isQPDiscardWhitespace(r rune) bool {
	switch r {
	case '\n', '\r', ' ', '\t':
		return true
	}
	return false
}

var (
	crlf       = []byte("\r\n")
	lf         = []byte("\n")
	softSuffix = []byte("=")
)

// 读取并解码底层读取器中引用的可打印数据。
func (r *Reader) Read(p []byte) (n int, err error) {
	// 与RFC 2045的偏差：
	// 1。除“=\r\n”外，“=\n”也被视为软换行符。
	// 2。它将通过一个前面没有“=”的“\r”或“\n”，与其他损坏的QP编码器和解码器一致。
	// 3。它接受消息末尾的软换行（=）（问题15486）；i、 e.
	// 从底层读取器读取的最后一个字节允许为“=”，
	// 并且将被静默忽略。
	// 4。如果后面不跟两个十六进制数字
	// 但不在行尾，则取=为literal=（问题13219）。
	for len(p) > 0 {
		if len(r.line) == 0 {
			if r.rerr != nil {
				return n, r.rerr
			}
			r.line, r.rerr = r.br.ReadSlice('\n')

			// 行是否以CRLF结尾而不是仅以LF结尾？
			hasLF := bytes.HasSuffix(r.line, lf)
			hasCR := bytes.HasSuffix(r.line, crlf)
			wholeLine := r.line
			r.line = bytes.TrimRightFunc(wholeLine, isQPDiscardWhitespace)
			if bytes.HasSuffix(r.line, softSuffix) {
				rightStripped := wholeLine[len(r.line):]
				r.line = r.line[:len(r.line)-1]
				if !bytes.HasPrefix(rightStripped, lf) && !bytes.HasPrefix(rightStripped, crlf) &&
					!(len(rightStripped) == 0 && len(r.line) > 0 && r.rerr == io.EOF) {
					r.rerr = fmt.Errorf("quotedprintable: invalid bytes after =: %q", rightStripped)
				}
			} else if hasLF {
				if hasCR {
					r.line = append(r.line, '\r', '\n')
				} else {
					r.line = append(r.line, '\n')
				}
			}
			continue
		}
		b := r.line[0]

		switch {
		case b == '=':
			b, err = readHexByte(r.line[1:])
			if err != nil {
				if len(r.line) >= 2 && r.line[1] != '\r' && r.line[1] != '\n' {
					// 将=作为文本=。
					b = '='
					break
				}
				return n, err
			}
			r.line = r.line[2:] // 3个中的2个；其他1在
		case b == '\t' || b == '\r' || b == '\n':
			break
		case b >= 0x80:
			// 下完成，作为RFC 2045的扩展，我们接受
			// 值>=0x80，没有任何抱怨。第22597期。
			break
		case b < ' ' || b > '~':
			return n, fmt.Errorf("quotedprintable: invalid unescaped byte 0x%02x in body", b)
		}
		p[0] = b
		p = p[1:]
		r.line = r.line[1:]
		n++
	}
	return n, nil
}
